PATHMac OS 8 and 9 Developer Documentation > Human Interface Toolbox > Window Manager >

Programming With the Mac OS 8.5 Window Manager

ValidWindowRect

Removes a rectangle from a window's update region.

pascal OSStatus ValidWindowRect (
                     WindowPtr window,
                     const Rect *bounds);
window
A value of type WindowPtr . Pass a pointer to the window containing the rectangle that you wish to remove from being updated.
bounds
A pointer to a structure of type Rect . Before calling ValidWindowRect , set this structure to specify, in local coordinates, a rectangle to be removed from the window's update region.
function result
A result code. See Result Codes.
DISCUSSION

The ValidWindowRect function informs the Window Manager that an area of a window no longer needs to be redrawn. The ValidWindowRect function is similar to the ValidRect function, but ValidWindowRect allows the window that it operates upon to be explicitly specified, instead of operating on the current graphics port, so ValidWindowRect does not require the graphics port to be set before its use. See Maintaining the Update Region for further discussion.

VERSION NOTES

Available with Mac OS 8.5 and later.

SEE ALSO

The function InvalWindowRect .

The function ValidWindowRgn .

© 1999 Apple Computer, Inc. – (Last Updated 18 March 99)